/**
 * vue.config.js 是一个可选的配置文件，如果项目的根目录中存在这个文件，那么它会被 @vue/cli-service 自动加载。
 * 这个文件应该导出一个包含了选项的对象，这些选项可以配置webpack、开发服务器、构建过程等项目所需的配置。
 * 主要用于：
 * 1. 调整 webpack 配置
 * 2. 配置开发服务器
 * 3. 设置构建输出位置
 * 4. 配置项目的环境变量
 * 5. 设置项目的基础路径等
 */

'use strict'
const path = require('path')
const defaultSettings = require('./src/settings.js')

// 解析路径的辅助函数
function resolve(dir) {
  return path.join(__dirname, dir)
}

const name = defaultSettings.title || 'vue Admin Template' // 页面标题

// 如果端口设置为80，
// 需要使用管理员权限来执行命令行
// 例如，Mac系统下: sudo npm run
// 你可以通过以下方式修改端口：
// port = 9528 npm run dev 或者 npm run dev --port = 9528
const port = process.env.port || process.env.npm_config_port || 9528 // 开发端口

// All configuration item explanations can be find in https://cli.vuejs.org/config/
module.exports = {
  /**
   * 如果你计划将你的站点部署到子路径下，你需要设置publicPath
   * 例如，如果你要将你的站点部署到 https://foo.github.io/bar/
   * 那么 publicPath 应该设置为 "/bar/"
   * 在大多数情况下请使用 '/' !!!
   * 详细信息: https://cli.vuejs.org/config/#publicpath
   */
  publicPath: '/',
  outputDir: 'dist', // 输出目录
  assetsDir: 'static', // 静态资源目录
  lintOnSave: process.env.NODE_ENV === 'development', // 是否在开发环境下启用eslint
  productionSourceMap: false, // 生产环境是否生成 sourceMap 文件
  devServer: {//开发服务器配置
    port: port,
    open: true, // 自动打开浏览器
    overlay: {
      warnings: false,
      errors: true
    },
    proxy: {//代理配置
      '/api': {  // 代理的请求前缀，所有以/api开头的请求都会被代理
        target: 'https://heimahr.itheima.net', // 代理的目标服务器地址
        // changeOrigin: true,  // 可选配置，用于控制请求头中host值
        // pathRewrite: {  // 可选配置，用于重写请求路径
        //   '^/api': ''  // 如果需要去掉/api前缀，可以启用这个配置
        // }
      }
    },
    // before: require('./mock/mock-server.js') // 配置mock服务器
  },
  configureWebpack: {// 配置webpack
    // 在webpack的name字段中提供应用程序的标题，以便可以在index.html中访问它来注入正确的标题
    name: name,
    resolve: {
      alias: {// 别名
        '@': resolve('src') // 设置@别名指向src目录
      }
    },
    // 配置打包时需要排除的包，以减少打包体积，
    //替代措施：在html中采用外链引入排除的文件
    externals: {
      'vue': 'Vue',
      'element-ui': 'ELEMENT',
      'cos-js-sdk-v5': 'COS'
    }
  },
  chainWebpack(config) {
    // 可以提高首屏加载速度，建议开启预加载
    config.plugin('preload').tap(() => [
      {
        rel: 'preload',
        // 忽略 runtime.js
        // https://github.com/vuejs/vue-cli/blob/dev/packages/@vue/cli-service/lib/config/app.js#L171
        fileBlacklist: [/\.map$/, /hot-update\.js$/, /runtime\..*\.js$/],
        include: 'initial'
      }
    ])

    // 当有很多页面时，会导致太多无意义的请求
    config.plugins.delete('prefetch')

    // 配置svg-sprite-loader处理svg图标
    //svg-sprite-loader打包了所有svg到一个svg标签上，
    //将svg名称作为symbol标签的id属性
    //svg-icon组件使用iconClass属性引用了symbol的id
    config.module
      .rule('svg')
      .exclude.add(resolve('src/icons'))
      .end()
    config.module
      .rule('icons')
      .test(/\.svg$/)
      .include.add(resolve('src/icons'))
      .end()
      .use('svg-sprite-loader')
      .loader('svg-sprite-loader')
      .options({
        symbolId: 'icon-[name]'
      })
      .end()

    // 生产环境配置
    config
      .when(process.env.NODE_ENV !== 'development',
        config => {
          config
            .plugin('ScriptExtHtmlWebpackPlugin')
            .after('html')
            .use('script-ext-html-webpack-plugin', [{
              // `runtime` 必须与 runtimeChunk 名称相同。默认是 `runtime`
              inline: /runtime\..*\.js$/
            }])
            .end()
          config
            .optimization.splitChunks({
              chunks: 'all',
              cacheGroups: {
                libs: {
                  name: 'chunk-libs',
                  test: /[\\/]node_modules[\\/]/,
                  priority: 10,
                  chunks: 'initial' // 只打包初始时依赖的第三方
                },
                elementUI: {
                  name: 'chunk-elementUI', // 将 elementUI 拆分为单独的包
                  priority: 20, // 权重要大于 libs 和 app，否则会被打包进 libs 或 app
                  test: /[\\/]node_modules[\\/]_?element-ui(.*)/ // 适配 cnpm
                },
                commons: {
                  name: 'chunk-commons',
                  test: resolve('src/components'), // 可以自定义规则
                  minChunks: 3, // 最小公共数量
                  priority: 5,
                  reuseExistingChunk: true
                }
              }
            })
          // https:// webpack.js.org/configuration/optimization/#optimizationruntimechunk
          config.optimization.runtimeChunk('single') // 将 runtime 代码拆分为一个单独的 chunk
        }
      )
  }
}
